home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / alarm320.arc / ALARM.DOC < prev    next >
Encoding:
Text File  |  1987-04-03  |  11.1 KB  |  249 lines
  1.  
  2.  
  3.  
  4.                   ALARM : Memory Resident Alarm Clock Program 
  5.                            Version 3.20, 03-Apr-1987
  6.                                   SMG Software
  7.  
  8.                            (C) Copyright 1986,1987 by
  9.                                Steven Georgiades
  10.                               All Rights Reserved
  11.  
  12.  
  13.  
  14.  
  15.          The ALARM program provides a memory resident alarm clock with five 
  16.     different alarm settings.  In addition, hourly chimes can be enabled to 
  17.     produce  westminster chimes on the hour.   Each of the five alarms  can 
  18.     have a message associated with it, up to 32 characters in length.  When 
  19.     the  alarm  time is reached,  the computer's current activity  will  be 
  20.     suspended, and an alarm window will appear in the middle of the screen, 
  21.     with the alarm number,  alarm time setting,  and the specified message.  
  22.     In addition,  a musical tune will be played,  a  different one for each 
  23.     alarm.  The tunes are as follows: 
  24.  
  25.  
  26.               Alarm #1 : Funeral March of the Marionettes 
  27.               Alarm #2 : Tri-Test
  28.               Alarm #3 : Holiday Road
  29.               Alarm #4 : When The Saints Go Marching In
  30.               Alarm #5 : Für Elise
  31.  
  32.  
  33.     Note that upon installation,  the message associated with each alarm is 
  34.     set to the title of the tune for that alarm, as listed above.  An alarm 
  35.     tune  can  be terminated before completion by pressing the Escape  key.  
  36.     Once  an  alarm has sounded,  the alarm message window  will  disappear 
  37.     immediately,   unless an asterisk was specified in front of  the  alarm 
  38.     time,  in which case the alarm message window will remain on the screen 
  39.     until  the  Escape key is pressed.   If a second alarm time  should  be 
  40.     reached before the Escape key is pressed,  that alarm will be signaled, 
  41.     and the original one will be aborted.  
  42.  
  43.  
  44.  
  45.     Command Format:
  46.  
  47.          ALARM n=[*]hh:mm[/"message"] | n=? | n=OFF | CON | COFF | ?
  48.  
  49.               n       = Alarm number (1-5)
  50.               *       = Make alarm stay on screen until Escape is pressed
  51.               hh:mm   = Alarm setting (Military time)
  52.               message = Optional alarm message
  53.               ?       = Give current alarm setting(s)
  54.               OFF     = Disable specified alarm
  55.               CON     = Enable hourly chimes
  56.               COFF    = Disable hourly chimes
  57. ALARM, Version 3.20                                                      Page 2
  58.  
  59.  
  60.  
  61.  
  62.     Examples:
  63.  
  64.  
  65.          ALARM 1=10:00           (Will change alarm setting #1 to 10:00.
  66.                                    The message will not be changed.)
  67.  
  68.          ALARM 2=17:00/"Test"    (Will change alarm setting #2 to 17:00.
  69.                                    The message will become "Test".)
  70.  
  71.          ALARM 5=*21:45          (Will change alarm setting #5 to 21:45, 
  72.                                    and cause the alarm message to remain 
  73.                                    on the screen until Escape is pressed.
  74.                                    The message will not be changed.)
  75.  
  76.          ALARM 1=?               (Will respond with the current status
  77.                                    of alarm #1.)
  78.  
  79.          ALARM COFF              (Will turn the hour chimes off.)
  80.  
  81.          ALARM ?                 (Will respond with the current status
  82.                                    if all five alarms.)
  83.  
  84.          ALARM 3=OFF             (Will turn off alarm #3.)
  85.  
  86.  
  87.  
  88.     Revision History:
  89.  
  90.          Version 3.10                  Initial Release.
  91.  
  92.          Version 3.11                  Modified for Polyphonic Music.
  93.  
  94.          Version 3.12                  Modified for more accurate timekeeping.
  95.                                        Changed quarter-hour chimes to hourly.
  96.  
  97.          Version 3.13                  Added alarm interrupt capability.
  98.                                        Modified so message stays on screen.
  99.                                        (Thanks to Robert Warren of El Paso
  100.                                         for these suggestions)
  101.  
  102.          Version 3.14                  Re-defined "*" Option.  Fixed hourly 
  103.                                        chimes to disappear upon completion. 
  104.  
  105.          Version 3.15                  Fixed bug that would cause the program 
  106.                                        to re-install if run above the 512K 
  107.                                        boundary.
  108.  
  109.          Version 3.20                  Improved handling of alarm overlaps.
  110. ALARM, Version 3.20                                                      Page 3
  111.  
  112.  
  113.  
  114.          Included  with  the  ALARM  program  are  a  number  of associated 
  115.     programs.  These are TIME_CHK,  DATE_CHK and  WEEKDAY.  These  programs 
  116.     allow you to test the current time,  date and day of week from within a 
  117.     batch file (ie. AUTOEXEC.BAT), and conditionally execute code.  
  118.          The DATE_CHK program will compare the  current  date  against  the 
  119.     date specified on the command line, and will return the following: 
  120.  
  121.          0, if the current date matches the specified date
  122.          1, if the current date does not match the specified date
  123.          2, if an error has occured
  124.  
  125.                   DATE_CHK mm/dd/yy | mm/dd/yyyy
  126.  
  127.     With DATE_CHK,  0 is a wildcard.  In other words,  if you run  DATE_CHK 
  128.     with the command line "DATE_CHK 00/15/00", it will return 0 on the 15th 
  129.     of the month (any month, any year).  
  130.          The  TIME_CHK  program  will  compare the current time against the 
  131.     time specified on the command line (military time), and will return the 
  132.     following: 
  133.  
  134.          0, if the current time is before the specified time
  135.          1, if the current time is exactly the specified time
  136.          2, if the current time is after the specified time
  137.          3, if an error has occured
  138.  
  139.                   TIME_CHK hh:mm[:ss]
  140.  
  141.          The WEEKDAY program will compare the day-of-the-week specified  on 
  142.     the  command line against the current day-of-the-week,  and will return 
  143.     the following: 
  144.  
  145.          0, if the current day-of-the-week matches that specified
  146.          1, if the current day-of-the-week does not match that specified
  147.          2, if an error has occured
  148.  
  149.                   WEEKDAY [SUN | MON | TUE | WED | THU | FRI | SAT]
  150.  
  151.     You only need to specify the first three characters of the day ("Sun"),
  152.     but any characters after the third are ignored, so you may specify the 
  153.     full day ("Sunday"), or any other word starting with the same three 
  154.     letters, for that matter ("Sunshine").  WEEKDAY is case insensitive, 
  155.     so you may enter the day in upper- or lower-case.
  156.          Since the TIME_CHK,  DATE_CHK, and WEEKDAY programs respond with a 
  157.     return code,  the result is used via the IF ERRORLEVEL construct within 
  158.     batch  files.  Please  read your DOS manual for furthur information.  A 
  159.     sample batch file is included with this package.  
  160.  
  161.          The current revision level of all of the  programs  in  the  ALARM 
  162.     package is as follows: 
  163.  
  164.          ALARM      Version 3.20        03-Apr-1987
  165.          DATE_CHK   Version 1.01        28-Oct-1986
  166.          TIME_CHK   Version 1.00        27-Oct-1986
  167.          WEEKDAY    Version 1.01        28-Oct-1986
  168. ALARM, Version 3.20                                                      Page 4
  169.  
  170.  
  171.  
  172.          This software is distributed as ShareWare.  "ShareWare" means that 
  173.     you  are granted free license to use and copy this software as much  as 
  174.     you like, within the following restrictions: 
  175.  
  176.          1).  It  is  distributed  in  its  original,   unmodified  form, 
  177.               including program and documentation. 
  178.  
  179.          2).  No  fee is charged for use,  copying or distribution  (With 
  180.               the exception of nominal "per disk" copying charges, not to 
  181.               exceed $6.00 per disk).  
  182.  
  183.          3).  The  program  may  not  be included  with  other  goods  or 
  184.               services  supplied for a fee,  unless written permission to 
  185.               do so is obtained in advance from the author.  
  186.  
  187.     You are not required to register your shareware,  but if you are  using 
  188.     the  program,   and  find it helpful,  you are  expected  to  register.  
  189.     Registration fees are as follows: 
  190.  
  191.               Full Registration (w/full support) ........ $25.00
  192.               Basic Registration (w/basic support) ...... $15.00
  193.  
  194.     Please make checks payable to Steven M.  Georgiades.  Note that you are 
  195.     not  LEGALLY  obligated  to  register,  but if  you  use  the  software 
  196.     regularly,  you are MORALLY obligated to do so.  Aside from easing your 
  197.     conscience,  basic registration will also get you a diskette containing 
  198.     the  latest  version  of the software (unless you  currently  have  the 
  199.     latest version, in which case I will send you the next major revision), 
  200.     a printed version of the documentation (8-1/2 x 11,  unless you specify 
  201.     6-1/4  x  8-1/2), and basic user support,  which means that I will work 
  202.     with you to resolve problems,  and will do minor customization.    Full 
  203.     registration will get you everything that basic registration does, plus 
  204.     full  user  support,   which includes telephone support and  all  major 
  205.     revisions  of  the  software  for  two (2)   years  from  the  date  of 
  206.     registration.    Fully  registered  users will  also  receive  new  SMG 
  207.     releases  from  time  to time for evaluation.    In  return  for  these 
  208.     evaluations,   the  user  will receive full registration  for  the  new 
  209.     software at no charge.   When you register,  please specify the name of 
  210.     the program, and the version number. 
  211.          Note that no support will be given to unregistered users EXCEPT in 
  212.     the  case of MAJOR bugs which preclude the unregistered user from using 
  213.     the program.  I  will then do my best to resolve these problems so that 
  214.     the user may evaluate the software fully.  
  215.  
  216. ALARM, Version 3.20                                                      Page 5
  217.  
  218.  
  219.  
  220.  
  221.  
  222.     This program is provided AS  IS  without  any  warranty,  expressed  or 
  223.     implied,  including  but  not  limited  to  fitfulness for a particular 
  224.     purpose.  
  225.  
  226.          If  you have any questions or comments about this or any other SMG 
  227.     program, or if you would like to register any SMG Software, write to me 
  228.     at the following address: 
  229.  
  230.                 Steven M. Georgiades
  231.                 SMG Software
  232.                 701-H South Hayward Street
  233.                 Anaheim, CA  92804
  234.  
  235.     Or leave a message for me on the Circuit Board:
  236.  
  237.                 The Circuit Board RBBS
  238.                 SysOp: Dave Kleinschmidt
  239.                 (714) 778-0948
  240.                 300/1200/2400 Baud, No Fee
  241.  
  242.     All  SMG  Software  is  initially released to the  public  through  the 
  243.     Circuit  Board.   The latest version of any SMG Software can always  be 
  244.     found there.  
  245.  
  246.     A diskette containing all of the latest SMG Software can be obtained by 
  247.     sending a check or money order for $6.00  to the above address.    Make 
  248.     all checks payable to Steven M. Georgiades.  Thank you.  
  249.